home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / mus / play / hip223.lha / HippoPlayer / HiP.doc < prev    next >
Text File  |  1996-03-21  |  60KB  |  1,708 lines

  1. ******************************************************************************  
  2.  
  3.                 /\       ___.                    ___.
  4.               _/  \____ |   |_________/\ ______ |   | _________
  5.               \___|    \|   \    __  /  \\_    \|   |/   _____/
  6.            Mb /   |     \   |\___  \/  | \|     \   /   __/ \
  7.              /    |   \     |   /   \  _  \   \    /    |    \
  8.             /     |___|\    |_______/  |___\__|\   \__________\
  9.        *---/______|-----\___|----/_____|--------\___|--------------*
  10.                     ** Hippopotamus Design Presents: **
  11.  
  12.                          *** HippoPlayer v2.23 ***
  13.  
  14.                      Copyright © 1994-1996 K-P Koljonen
  15.                               ** SHAREWARE **
  16.  
  17. ******************************************************************************
  18.  
  19.  
  20. HippoPlayer (HiP) is a multiformat module player for the Amiga.  It works
  21. perfectly under Kickstart 1.2 and has all the same and even more features
  22. than the players requiring Kick2.0+ to run.
  23.  
  24. One main reason why I started making this program was that there were no
  25. good Kick1.3 compatible players around, or I didn't know of one (that was
  26. back in 1994 when I had A500).  The other reason was that my good friend
  27. Jarno Paananen (Guru/Sahara Surfers) made a replay routine for
  28. Screamtracker ]I[ modules, and I wanted a good GUI for it.
  29.  
  30. The aim was to make a good module player that works on every Amiga
  31. configuration and has lot's of USEFUL features.  To achieve speed, little
  32. size and memory usage, HiP is 100% assembler.  Project HippoPlayer was
  33. started 5.2.1994.
  34.  
  35. "Newcomers will run screaming away", said Nemesis1.
  36. At first HiP may seem complicated.  There's no familiar tapedeck symbols,
  37. only some bits of text scattered around.  Learn to use HiP, it should be
  38. worth the effort :)...
  39.  
  40. HiP has good support for Screamtracker ]I[, Fasttracker 1 & 2, Taketracker,
  41. and Multitracker modules (from here onwards referred as PS3Ms), meaning
  42. that you can listen them with a 68000 Amiga with listenable quality.  All
  43. are played by the famous replayer by Guru.  HiP was the second program to
  44. use the PS3M-routines after Guru's own player.
  45.  
  46.  
  47.  Some features:
  48.  · Screamtracker ]I[, Fasttracker 1 & 2, Taketracker, Multitracker, 1 to 32ch
  49.  · SID-emulation by Håkan Sundell & Ron Birk (works even on kick1.2)
  50.  · TFMX-modules, normal and the seven channel ones
  51.  · A bunch of 4-8 channel sample & synth music formats
  52.  · Easy to use, nice 3D-interface
  53.  · Keyboard control
  54.  · AppWindow
  55.  · ARexx 
  56.  · Public screen support
  57.  · Internal multitasking
  58.  · Loads and decompresses XPK, FImp, PowerPacker, LhA, LZX and Zip files
  59.  
  60. HippoPlayer has been tested on:
  61.      A500/000/7MHz, kick 1.2, 0.5+0.5M memory (my _old_ Amiga)
  62.      A500/000/7MHz, kick 1.3, 0.5+0.5M memory
  63.      A500/000/28MHz, kick 3.1, 1+2M memory
  64.      A1200/020/14MHz, kick 3.0, 2+0M memory
  65.      A1200/030/28MHz, kick 3.0, 2+4M memory (my Amiga)
  66.      A1200/030/50Mhz, kick 3.0, 2+4M memory
  67.      A4000/040/25MHz, kick 3.1, 2+8M memory
  68.  
  69. HippoPlayer was/is developed on:
  70.     - v1.00-v1.25    A500/010, kickstart 1.3/3.1, 1+2M memory, HD
  71.     - v1.27-v1.40    A1200/020, kickstart 3.0, 2+0M memory, HD
  72.     - v2.00-v?.??    A1200/030, kickstart 3.0, 2+4M memory, HD
  73.  
  74.  
  75.  
  76. ******************************************************************************
  77. *                            *** Registration ***                     *
  78. ******************************************************************************
  79.  
  80. HippoPlayer is shareware and copyright © 1994-96 K-P Koljonen. 
  81.  
  82. If you like using HiP and would like to encourage me to continue developing
  83. it and help me as well (as I'm a poor student ;), you should consider
  84. registering.
  85.  
  86. To register, send a disk and some money to my address found at the bottom
  87. of this doc.  Remember to mention your address!  And DO SEND A DISK!!
  88.  
  89. Amount of money needed for the registration in different currencies:  40
  90. FIM, 60 SEK, 15 DEM, 60 NOK, 6 GBP, 10 USD (you can send other currencies
  91. too, these are just examples).
  92.  
  93. You will get the disk back with the latest version of HiP and a key file,
  94. which you must not spread (no point in doing that anyway).  It is for your
  95. own use only.  This key file will work with possible future versions too.
  96.  
  97. Registering by e-mail is also possible.  Send the money by normal mail and
  98. I will mail you the key file.
  99.  
  100. There's no difference between registered and unregistered version!
  101.  
  102. Support quality software, register.
  103.  
  104.  
  105. ******************************************************************************
  106. *                            *** Distribution ***                     *
  107. ******************************************************************************
  108.  
  109. HippoPlayer can be freely distributed as long as all files are included
  110. unaltered.  Not for commercial use without a permission from the author.
  111.  
  112. Amiga magazines wishing to put HiP into a cover disk should send me the
  113. corresponding maggy number for free.
  114.  
  115.  
  116.  
  117. ******************************************************************************
  118. *               *** How and where to get the latest versions ***             *
  119. ******************************************************************************
  120.  
  121. To obtain the latest version of the HippoPlayer via modem, follow the
  122. instructions below.
  123.  
  124.  
  125. 1. Dial The Chameleon BBS: +358-81-5409545
  126.                            +358-81-5409545
  127.                            +358-81-5546450
  128.  
  129. 2. Select the display mode that suits your needs
  130.  
  131. 3. In the handle prompt, enter 'support'
  132.  
  133. 4. To browse the filelist, enter 'NEW 2' and use either
  134.    'T'ag command, or cursor keys to select the files you
  135.    want to download.
  136.  
  137. 5. If you want to report some bugs or suggest improvements to
  138.    the developer of HippoPlayer (K-P) enter 'E' and address
  139.    the message to 'K-P'. If you want to, you can make
  140.    it a private message by entering 'Y' to the query.
  141.  
  142. 6. If you've got some software related to HippoPlayer, that
  143.    you would like to be spread, you can upload it to the
  144.    HippoPlayer -directory with the 'U' command.
  145.    Please place the file in the HippoPlayer directory (2)
  146.    and describe the file.
  147.  
  148. 7. To leave the BBS simply enter 'G'
  149.  
  150.  
  151. You can also try the JuJu mAgicBoArD.  Ask Zymosis membahs for numbahs.
  152.  
  153. Those who have access to aminet can go and download HiP from mus/play
  154. directory (hip???.lha).
  155.  
  156. Or, from my WWW page: http://direktor.voima.jkl.fi/~kp
  157.  
  158.  
  159. ******************************************************************************
  160. *                           *** Requirements ***                     *
  161. ******************************************************************************
  162.  
  163. Any Amiga with some memory and Kickstart 1.2 or higher.  Reqtools.library
  164. of any version will be needed for the requesters.  There is kick1.3
  165. reqtools.library included in the archive.
  166.  
  167. In order to...             you need...
  168. ------------------------------------------------------------------
  169. Load XPK files            xpkmaster.library and some sublibs
  170. Load PowerPacker files        powerpacker.library
  171. Load lha, lzx and zip files    to look at 'Archivers'
  172. Load other packed file formats  to have xfdmaster.library
  173. Play SID files            PlaySID.library
  174. Play 4ch MED modules        medplayer.library v2+
  175. Play 5-8ch MED modules        octaplayer.library v2+
  176.  
  177. All libraries must be copied into Libs: drawer.
  178.  
  179. reqtools.library and powerpacker.library by Nico François.
  180. xpkmaster.library by Urban Dominik Müller.
  181. PlaySID.library by Per Håkan Sundell & Ron Birk.
  182. medplayer.library and octaplayer.library by Teijo Kinnunen.
  183. xfdmaster.library by Georg Hörmann.
  184.  
  185.  
  186. Installation
  187. ------------
  188. Copy HiP and one of the info-files to wherever you keep your tools.
  189.  
  190. Copy HippoPlayer.group into S:  or define the location later in
  191. Prefs/Player group.
  192.  
  193. Copy HippoPlayer.PS3M into S:.
  194.  
  195. Copy reqtools.library in Libs:  (the included lib is kick1.3 version)
  196.  
  197.  
  198.  
  199. ******************************************************************************
  200. *                           *** Music formats ***                     *
  201. ******************************************************************************
  202.  
  203. Here's a list of the music formats HippoPlayer can play and what functions
  204. they support.  Also the authors of the replayers are listed.
  205.  
  206. Stop/Continue     = 1 - The music can be stopped and continued.
  207. Multiple songs    = 2 - Modules can have more than one song.
  208. Volume          = 3 - Volume can be controlled.
  209. End detect      = 4 - Songend can be detected.
  210. Forward/backward  = 5 - You can jump forwards and backwards in the song.
  211. CIA fast forward  = 6 - Play 2x or 4x faster with LMB/RMB and '>'
  212.  
  213. Replayer            123456     Author
  214. --------------------------------------------------------------------
  215. [** Built-in replayers **]
  216. David Whittaker            xx---x*     David Whittaker
  217. Delta Music v2.0        x-x--x*     Bent Nielsen
  218. Fred                xx---x*     Frederic Hahn & JC
  219. Hippel                xx---x*     Jochen Hippel
  220. Maniacs of Noise        xxx--x*     Maniacs of Noise
  221. Mark II                x----x*     Cachet Software
  222. MED 4-8ch (player libraries)    xx-xx-     Teijo Kinnunen
  223. Music Assembler            x-x--x*     Oscar Giesen & Marco Swagerman
  224. Old Soundtracker        xxxxxx     K-P Koljonen
  225. Protracker            xxxxxx     K-P Koljonen
  226. SID (player library)        xx--x-     Håkan Sundell & Ron Birk
  227. SIDMon v1.0            x----x*     Reiner van Vliet
  228. Sonic Arranger            -x----*     Carsten Schlote
  229. IFF 8SVX samples        --x---     
  230.  
  231. [** Replayers in player group file **]
  232.  
  233. BP SoundMon v2.0        x-xxxx      Brian Postma
  234. BP SoundMon v3.0 (v2.2?)    x-xxxx      Brian Postma
  235. Future Composer v1.0-v1.4    x-xx-x     SuperSero (of the Superions)
  236. Hippel-COSO            xxxx-x     Jochen Hippel
  237. JamCracker            x--x-x     M. Gemmel
  238. Oktalyzer            --xx--     Armin Sander
  239. PS3M                x-xxx-     Jarno Paananen
  240. TFMX                xxxxx-     Chris Hülsbeck
  241. TFMX 7ch            xxxxx-     Chris Hülsbeck & Jochen Hippel
  242. The Player 6.1A            x-x---     Jarno Paananen
  243. DIGI Booster            x-xxx-      Tomasz Piast (Tap)
  244.  
  245.  
  246. The modules of formats marked with '*' have the replay code inside the
  247. module itself.  I can't guarantee will they work or not.  This is also the
  248. reason why they are not in the player group file (no replay code).
  249.  
  250. Most of the formats included are here just because I have some modules of
  251. each format and I like to play them with HiP.  :)
  252.  
  253.  
  254. Player group (See Prefs)
  255. ------------
  256. Player group (HippoPlayer.Group) is a file consisting of above mentioned
  257. replayers.  The reason for this is that by moving seldom used replayers
  258. into a separate file memory usage is reduced by about 40-50kB.  Not that
  259. much, you think.  But maybe just enough to prevent some actions from
  260. happening on low memory systems/situations.
  261.  
  262.  
  263.  
  264. Loading files
  265. -------------
  266. Normally all modules will be loaded in CHIP.  SID-, Oktalyzer- and PS3M-
  267. modules and TFMX song data will be loaded in FAST RAM if possible.
  268.  
  269. All compressed files will be loaded in CHIP.  However, it's possible to
  270. uncompress one chunck from the beginning of an XPKed file, and check if it
  271. is one of the above or a PT module that is to be played with PS3M or with
  272. fastram replayer (if user has selected PT fastram player or the module
  273. doesn't fit into chip ram).
  274.  
  275. Advantages of loading to FAST:
  276.     FAST RAM is much faster than CHIP, so mixing can be done faster.
  277.     CHIP RAM is saved if the module can or should be loaded in FAST.
  278.  
  279. LhA, LZX and Zip files can be checked and will be loaded in FAST if
  280. necessary.
  281.  
  282.  
  283.  
  284. Protracker
  285. -----------
  286. The most popular music format on the Amiga.  HiP features my own Protracker
  287. play routine.
  288.  
  289. - Multisong modules
  290. There are some modules around with several songs separated by the B
  291. command.  HiP allows you to play these kind of modules correctly.  Just use
  292. the 'PS' and 'NS' gadgets (or the respective keys) to select different
  293. songs.  The only player that supports this feature, by the way :)
  294.  
  295. - Fast ram player
  296. This player can play PT modules from FAST RAM using only 1024 bytes of CHIP
  297. RAM.  Useful for very big modules.
  298.  
  299. - Old Soundracker modules
  300. HiP identifies old Soundtracker modules and converts them to the Protracker
  301. format.  This will take memory temporarily twice the module size, but I
  302. don't think it's a big problem because old ST tunes tend to be very small.
  303.  
  304.  
  305.  
  306. TFMX
  307. ----
  308. HiP can play both 4 and 7-channel TFMX modules, including the excellent
  309. Turrican 1, 2 and 3 intro tunes.  A TFMX module consists of two files.
  310. They must be named 'mdat.<name>' and 'smpl.<name>'.  To play, select
  311. 'mdat.<name>'.  HippoPlayer will then try to load the 'smpl.<name>' file.
  312. Alternatively you can use the TFHD format TFMX modules.
  313.  
  314. The mixing rate of TFMX 7 channel replayer can be changed.  The bigger
  315. value, the better quality and bigger CPU load.  If you lose some notes or
  316. hear 'crackling' in the sound try lowering the mixing rate.
  317.  
  318.  
  319.  
  320. PS3M 
  321. ----
  322. (Screamtracker ]I[, Protracker, Fasttracker 1 & 2, Taketracker, Multitracker)
  323.  
  324. Jarno Paananen (Guru/Sahara Surfers) has made replayers for these.  It is
  325. able to play 1-32 voices simultaneously by mixing them through four
  326. channels.  The mixing routine is amazingly fast, even on Amiga 500 8
  327. channel modules are very listenable.  The replayer gobbles quite a bit of
  328. memory for it's buffers, so don't be surprised.
  329.  
  330. Mixing rates can be changed.  Again, the bigger value, the better quality
  331. and bigger CPU load.  Using the system friendly mode on A500 will probably
  332. more or less jam the machine, therefore you should use the killer mode for
  333. the best quality. 
  334.  
  335. PS3M allows mixing rates higher than 28 kHz, which is normally the hardware
  336. limit.  In some AGA (ECS too?) screenmodes higher mixing rates are
  337. possible.  This is what I found out after some experimenting.  I used
  338. maximum overscan.
  339.  
  340. Maximum mixing rates for screenmodes:
  341.  
  342. PAL..........28 kHz        
  343. NTSC.........28 kHz
  344. Euro36.......28 kHz
  345. DblPAL.......54 kHz
  346. DblNTSC......54 kHz
  347. Euro72.......58 kHz
  348. Multiscan....58 kHz
  349. Super72......46 kHz
  350.  
  351. NOTE:  If you use too high a mixing rate, the sound will be distorted.
  352.  
  353. Killer mode WILL cause enforcer hits!  It bangs some of the interrupt
  354. vectors.  Don't use enforcer with killer mode.
  355.  
  356. These modules can and should be played from FAST RAM.
  357.  
  358. Play mode
  359. - - - - -
  360. Surround    Play some of the right side on the left and vice versa.
  361.         The stereo value can be adjusted with the stereo slider in Prefs.
  362.         50% is normal surround, 0% is mono and 100% is stereo.
  363. Stereo        Stereo, play half of the channels on left and half on right.
  364. Mono        Mono, play all channels on both sides.
  365. Real Surround    About the same, but uses more memory.
  366. 14-bit stereo    BEST QUALITY, biggest CPU load, largest memory usage and
  367.         lowest volume level.
  368.  
  369. The best play mode for most situations is Stereo.  For modules with lot's
  370. of channels use 14-bit stereo.
  371. You can play modules in stereo or in mono with Surround play mode by
  372. adjusting the stereo value.  The difference between this and the real Mono
  373. and the real Stereo modes is a lower volume level.
  374.  
  375.  
  376. PS3M configuration file
  377. -----------------------
  378. It is possible to control PS3M via config file:  'S:HippoPlayer.PS3M'.  HiP
  379. will configure PS3M according to the config file every time a module is
  380. loaded.
  381. In HippoPlayer.PS3M you can enter PS3M settings for each number of channels
  382. and for specific modules. 
  383. In channel and song settings you may replace the number you don't want to
  384. alter with ?'s.  Useful when you want to control the mixing rate from HiP
  385. and the volume boost the PS3M from config file.
  386. The file is quite self-explanatory so you should be able to edit it with no
  387. problem.
  388. If you don't want to use the config file you can delete it from S:  or
  389. disable it from prefs.
  390.  
  391.  
  392. SID
  393. ---
  394. These are tunes ripped from C64 games & demos.  Both normal file + icon and
  395. one file formats are supported.  The playing is done by PlaySID.library by
  396. Håkan Sundell and Ron Birk.  Great job dudes!
  397.  
  398. *** Note 1:  Under Kickstart 1.2/1.3 playsid.library v1.1 does not work
  399. because it uses some Kick2.0+ functions.  I have made a little patch to
  400. bypass the problem.  This patch works ONLY with lib version v1.1 and
  401. Kick1.2/1.3.
  402.  
  403. *** Note 2:  If you are using the excellent Executive you should switch it
  404. to use some other timer than CIAB because playsid.library needs the CIAB
  405. timers for playing.
  406.  
  407.  
  408.  
  409. IFF samples
  410. -----------
  411. HiP is currently able to play IFF 8SVX unpacked mono samples directly from
  412. disk by using user definable amount of CHIP RAM for buffers.
  413.  
  414.  
  415.  
  416. ******************************************************************************
  417. *                     *** Gadgets & keyboard controls ***                    *
  418. ******************************************************************************
  419.  
  420. Keyboard shortcuts are bracketed.  The keys work from both main window and
  421. prefs window.
  422.  
  423.  New    Clear the module list, select new modules and play the first one.
  424.  
  425.  Play    Load and/or play selected module. If nothing selected, pop up
  426.     file requester. [RETURN/ENTER]
  427.  
  428.  Cont    Continue playing after stop.
  429.  
  430.  Stop    Stop playing.
  431.  
  432.  Eject    Stop playing and free current module. [TAB]
  433.  
  434.  Prev    Load and play previous module. [K]
  435.  
  436.  Next    Load and play next module. [L]
  437.  
  438.  PS    Play previous song. [ARROW LEFT]
  439.  
  440.  NS    Play next song. [ARROW RIGHT]
  441.  
  442.  <    Backward, jump to previous pattern. [,]
  443.  
  444.  >    Forward, jump to next pattern. [.]
  445.     If the module format supports pos/len, LMB with '>' jumps to
  446.     next pattern and RMB '>' doubles the playing speed.
  447.     If the format doesn't support pos/len, then LMB '>' will double
  448.     the playing speed, and RMB '>' will quadruple the playing speed.
  449.     To get the normal playing speed press 'Cont' or '>' again.
  450.     Key for RMB '>' is shift ',' or shift '3' in number pad.
  451.     
  452.  Add    Add modules to the end of the list, pop up the file requester. [A]
  453.     When adding files to the list you can also add directories.
  454.     With Kick2.0+ HiP will perform a recursive directory scan adding all
  455.     files in dir to the list. With Kick1.2/1.3 only one sub dir is added.
  456.  
  457.  Add + right mousebutton [Q]
  458.     Add a list divider into the list.
  459.  
  460.  Del    Delete selected module from the list. [BACKSPACE]
  461.  
  462.  Del + right mousebutton [SHIFT+BACKSPACE]
  463.  
  464.     Pressing RMB+Del will nuke a file, ie remove it from the list as
  465.         well as from the DISK! So watch out.
  466.  
  467.     RMB+Del on a divider will remove the divider and all the files 
  468.         'under' that particular divider from the list.
  469.  
  470.     RMB+Del will produce a 'Are you sure?' requester, while SHIFT+
  471.     BACKSPACE won't.
  472.  
  473.  Clr    Clear the list. [D]
  474.  
  475.  Horizontal slider
  476.     Volume controller. [B][N]
  477.  
  478.  ?      Enter the info window. [HELP]
  479.       Two to three choices here:
  480.  
  481.       Module info  Display information about the current module.
  482.                Module info can also be invoked by pressing left
  483.                 mousebutton on the leftmost third of the name/type
  484.                        box or the 'I' key.
  485.                Module info window will be updated if you keep it
  486.                open and load a new module.
  487.                Close module info by clicking or pressing
  488.                again. Scroll the list with the gadget or the
  489.                arrow keys (faster scroll with shifts).
  490.                Close the window by pressing Esc in the window.
  491.           More         About HiP.
  492.           Exit         Hmm..
  493.  
  494.  Prefs    Pop up the prefs window. You can also close it with this button.
  495.  
  496.  Mo    Move the chosen module. [M]
  497.     Removes the module from list allowing you to move around.
  498.     To insert it back press Mo again or Play (or the keys).
  499.  
  500.  Mo + right mousebutton [F/SHIFT+F]
  501.     Find module according to given search pattern.
  502.     [F] asks for a pattern to be searched and [SHIFT+F] continues searching.
  503.  
  504.  In    Insert modules after the selected module. [I]
  505.     This is almost the same as 'Add'.
  506.  
  507.  In + right mousebutton [S]
  508.     Sort list alphabetically. With lot's of files this may be a
  509.     bit slow (bubble sort).
  510.  
  511.  Lp    Load module program. [P]
  512.  
  513.  Lp + right mousebuttton {[} (the key besides P)
  514.     Join a module program to the module list.
  515.     
  516.  Sp    Save module program. [W]
  517.  
  518.  The leftmost propgadget
  519.     Scroll module list.
  520.  
  521.  Windowclose-button [ESC]
  522.     Close all windows except requesters and exit.
  523.  
  524.  RMB on the 1/3 of the infobox
  525.     Toggle scope on/off.
  526.  
  527.  ** Other keys **
  528.  ARROW UP    Select previous module.
  529.  ARROW DOWN    Select next module.
  530.  SPACE        Toggle play/stop.
  531.  *, (next to RETURN) Randomize and play a module.
  532.  7,8,9,0    Show: time-pos/len-song number, clock-free mem, module name,
  533.         time/duration-pos/len.
  534.  Z              Toggles selected scope.
  535.  F1-F10        Load & play a module or a module prorgram.
  536.  `~ (next to 1)    Zip window (also shows when hidden).
  537.  
  538.  lamiga-lshift-control + h
  539.         Hides HiP and shows when pressed again.
  540.  
  541.  lamiga-lshift-control + 1
  542.         Zip window key for inactive window. 
  543.  
  544. *** Number pad ***
  545. [ ] / *      [ = del, ] = move, / = insert, * = play random
  546. 7 8 9 -      7 = play previous, 8 = select previous, 9 = play next, - = vol down
  547. 4 5 6 +      4 = prev song, 5 = stop/cont, 6 = next song, + = vol up
  548. 1 2 3 E      1 = rewind, 2 = select next, 3 = fast forward, enter = play
  549. 0 0 . E      0 = add files, . = load program, enter = play
  550.  
  551. *** Keyboard note ***
  552. Press lamiga-lshift-control-<key> to use the HiP-keys WITHOUT first
  553. activating the window.  This is one of the two ways (the other is ARexx) to
  554. control HiP when it is hidden!  Pressing zip window this way will bring the
  555. window to front and activate it.
  556.  
  557. *** File requester note ***
  558. HiP uses the great reqtools-requesters.  To select multiple files click
  559. files with shift pressed!  You can also select directories when 'Add'ing or
  560. 'In'serting.
  561.  
  562.  
  563. Filebox
  564. -------
  565. Here you can see the module list.  You can select a module by pressing the
  566. left mousebutton on it or by pressing arrows up and down.  The selection
  567. bar will be kept visible.
  568.  
  569.  
  570. Right mousebutton
  571. -----------------
  572. Pressing the right mousebutton or the respective key will shrink the window
  573. so that only the titlebar will be shown.  Press again on the activated
  574. window to expand.
  575. If you somehow lose the window, just load the program again.  If there
  576. already was one HippoPlayer running, it's window will be popped to front
  577. and expanded.  Also pressing lamiga-lshift-control+`~ will pop the window
  578. to front.
  579.  
  580.  
  581.  
  582.  
  583. ******************************************************************************
  584. *                              *** Prefs ****                     *
  585. ******************************************************************************
  586.  
  587. Here you can configure HippoPlayer by using the gadgets & buttons.
  588. Multiple choice requester can be invoked by pressing right mousebutton on
  589. the cycle gadgets with 'ears'.
  590.  
  591.  
  592. Play
  593. ----
  594.  List repeatedly    Play module list over and over.
  595.  List once        Play list once stop.
  596.  Module repeatedly    Play one module over and over.
  597.  Module once        Play one module once and stop.
  598.  Modules in random order
  599.         Play modules in random order.
  600.         When playing has started, same module will not be played twice
  601.                 unless all modules have been played first.
  602.              
  603. 'Play'  affects  the  replayers  where  the end of the song can be detected
  604. from.
  605.  
  606.  
  607.  
  608. Timeout
  609. -------
  610. Set playing time (mins:secs).  Disabled in the leftmost position.  Timeout
  611. can affect all modules or only those which the end can't be detected from.
  612. You can select this by pressing 'Timeout'.
  613.  
  614. Example:  Play Protracker-modules until they end and PSIDs for, say 3
  615. minutes.  Or you can play all kinds of modules for only 30 secs (intro scan
  616. :)
  617.  
  618.  
  619.  
  620. Alarm
  621. -----
  622. Set a time for HiP to play a module (same as startup module).  Control
  623. alarm with the slider, hh:mm.  To enable alarm, set titlebar info to clock.
  624. To re-enable alarm, switch titlebar info to something else and then back to
  625. clock.
  626.  
  627.  
  628.  
  629. Startup
  630. -------
  631. When enabled (with the checkbox left to alarm), HiP will start playing
  632. immediately on startup.  The module or the program to be played can be
  633. chosen by clicking the 'Startup' gadget.
  634.  
  635.  
  636.  
  637. Function keys
  638. -------------
  639. You can install a module or a module program for each of the function keys
  640. (F1-F10) by clicking this gadget.  Then when you press a fkey, the
  641. corresponding module program or module will be loaded and played.
  642.  
  643.  
  644.  
  645. Hotkeys
  646. -------
  647. Enable/disable lamiga-lshift-control-<key> keys.  This is for preventing
  648. collisions with other programs that may be using the same key combination.
  649.  
  650.  
  651.  
  652. Doubleclick
  653. -----------
  654. When enabled, a module can be loaded and played by doubleclicking on it.
  655.  
  656.  
  657.  
  658. Continue on error
  659. -----------------
  660. Errors that occur while loading will be ignored, file will be skipped and
  661. the next one will be loaded.  After five errors the procedure will be
  662. halted.
  663.  
  664.  
  665.  
  666. Early load
  667. -----------
  668. Select a pattern from end to start loading next module.  Works with formats
  669. supporting position/length.
  670.  
  671. Currently this is quite a lame function, because the newly loaded module
  672. starts to play immediately.
  673.  
  674.  
  675.  
  676. Divider / dir
  677. -------------
  678. When adding directories, it is sometimes useful to have a list divider for
  679. each scanned directory.  This switch does just that.
  680.  
  681.  
  682.  
  683. Priority
  684. --------
  685. Select a priority for HiP's processes:  -1, 0, +1.  All excluding the
  686. scopes are affected.
  687.  
  688.  
  689.  
  690. Show (titlebar information)
  691. ----
  692.  Time, pos/len, song    Show playing time, song position/length and
  693.             song number/max song (#n/n) depending of what kind
  694.             of a module is being played, and module name.
  695.  Time/duration, pos/len    This does exactly the same as above with all but
  696.             Protracker modules. If enabled, HiP will calculate
  697.             duration of PT modules and show it in the titlebar.
  698.  Clock, free memory     Show clock (24h) and free CHIP and FAST in kilobytes.
  699.  Module name        Show module name only.
  700.  
  701.  
  702.  
  703. Screen
  704. ------
  705. Select a public screen.  All HiP's windows and requesters will be opened on
  706. the defined screen.  If the screen is not available, default screen will be
  707. used (usually Workbench).
  708.  
  709.  
  710.  
  711. Filebox (size)
  712. --------------
  713. Define the number of files showed simultaneously in the main window.
  714. Minimum is 3 and maximum is 50.  If the value is too big for the current
  715. screen it will be truncated.
  716. The filebox can be removed from the window by selecting size 0.
  717.  
  718.  
  719.  
  720. Module info (size)
  721. ------------------
  722. Select the amount of lines the module info window can hold.
  723.  
  724.  
  725.  
  726. Font
  727. ----
  728. Select a 8x8 pixel font (kick2.0+ only).  All fixed width and 8 pixel high
  729. fonts will be scanned and only those that are 8x8 pixel fonts are
  730. displayed.
  731.  
  732.  
  733.  
  734. Scopes
  735. ------
  736. Select one of the scopes by clicking the type gadget and the bar gadget.
  737. The 'Scope on/off' button or 'z' key or RMB on the 1/3 of the infobox will
  738. start it up.  You can close a scope by closing it's window or clicking the
  739. gadget again.
  740.  
  741. These are for Protracker-modules only:
  742.  
  743. Quadrascope (& bars)
  744.  - This is just like the one in Protracker.  Channel order:  1,2,3,4.
  745. Hipposcope (& bars)
  746.  - Couldn't invent a better name..  Bass-sounds look nice with this one.
  747.    Channel order: 1,2,3,4.
  748. Frequency analyzer (& bars)
  749.  - This one's more processor intensive.  There is one for the left and the
  750.    right side. It is supposed to display frequencies while not using
  751.    period values. This is not FFT, but is based on Guru's strange idea...
  752.    Bass-sounds are on the left and treble-sounds on the right.
  753.    Bar channel order: 1,4,2,3.
  754. Patternscope
  755.  - Protracker-emulator... Shows pattern data, four fake VU-meters and four
  756.    tiny period boxes.
  757.    Channels: 1,2,3,4.
  758. F. Quadrascope (& bars)
  759.  - F. stands for filled. Inspired by Guru/S2's routine many years ago.
  760.    Channels: 1,2,3,4.
  761. Bars
  762.  - These will try to visualize the volume and the period of each channel.
  763.    The vertical position represents sample period and the width sample volume.   
  764.  
  765. There are almost the same scopes for PS3M:  Quadrascope (stereoscope),
  766. hipposcope, frequency analyzer and filled quadrascope (stereoscope).  No
  767. bars.
  768.  
  769. The IFF sample player has monoscope and filled monoscope.
  770.  
  771. The scopes will need some kilobytes of memory for buffers.  They are run
  772. with priority of -30 so that they won't interfere with anything important.
  773.  
  774.  
  775.  
  776. Prefix cut
  777. ----------
  778. Select filename prefix cut.  Value 3 will cut prefixes like "mod.", "xm."
  779. etc.  from the names in the filebox.
  780.  
  781.  
  782.  
  783.  
  784. Player group
  785. ------------
  786. Status:     Player group loaded/not loaded.
  787. Mode:        Loading conditions
  788.         - All on startup: load the group immediately on startup
  789.         - All on demand: load the group when there is demand for
  790.                      a replayer
  791.         - Disable: don't load the group and unload if already loaded
  792.         - Load single: load a single replayer from the group 
  793.               when needed
  794. File:        Player group file.
  795.  
  796.  
  797.  
  798. Filter control
  799. --------------
  800. Filter controlled by module, filter forced off or on.
  801.  
  802.  
  803.  
  804. Fade volume
  805. -----------
  806. This will cause those replayers that support volume to fade music in and
  807. out.
  808.  
  809.  
  810.  
  811. Nasty audio
  812. -----------
  813. Select allocation priority of the audio channels.  When on, no program
  814. except HiP can use the channels.  PS3M uses maximum priority at all times.
  815.  
  816.  
  817.  
  818. VBlank timer
  819. ------------
  820. Select timing method to be used for playing: VBlank or CIA timer.
  821.  
  822. Use this switch if you don't want HiP to use one of the four CIA timers.
  823. VBlank plays with wrong speed on non-50Hz screens.
  824.  
  825. This switch has no effect on the following:  PS3M, SID, Sonic Arranger,
  826. TFMX, TFMX 7c, MED, The Player 6.1a.  They use their own way of timing.
  827.  
  828. Tempo will be disabled when playing PT mods with VBlank timer.  Double and
  829. quadruple playing speeds are disabled when using VBlank.
  830.  
  831.  
  832.  
  833. PT replayer
  834. -----------
  835. Normal:  Use normal Protracker replayer to play modules from CHIP RAM.
  836. Fastram: Play PT modules from FAST RAM.
  837. PS3M:     Use Guru's PS3M to play modules from CHIP or FAST.
  838.      This way you can use those neat modes, eg listen Protracker
  839.      modules with real surround.
  840.  
  841.  
  842.  
  843. Protracker tempo
  844. ----------------
  845. Enable or disable Protracker tempo command.  Apply on old modules that use
  846. speeds higher than $1F.  Applies also to The Player modules.
  847.  
  848.  
  849.  
  850. TFMX rate
  851. ---------
  852. Mixing rate for the 7-channel TFMX replayer.
  853.  
  854.  
  855.  
  856.  
  857. Sample buffer (size)
  858. --------------------
  859. Define the CHIP RAM buffer size for the IFF sample player.  The actual
  860. memory used is double the amount.  Small value might be good for fast HDs,
  861. while big can be better with slower media.
  862.  
  863.  
  864.  
  865. Module directory
  866. ----------------
  867. Select default module directory.
  868.  
  869.  
  870.  
  871. Program directory
  872. -----------------
  873. Same as above but for module programs.
  874.  
  875.  
  876.  
  877. Archivers (LhA... LZX... Zip...)
  878. ---------
  879. HiP can decompress and play modules packed with LhA, LZX and Zip.  You need
  880. to specify a path, a command and options for each.
  881.  
  882. Archives will be extracted into a temporary directory that will be created
  883. in the user defined path.  (RAM:  is always the fastest while HD is good
  884. for saving memory.) The directory is then scanned for files and music
  885. module-looking files will be loaded.  This method of loading is very useful
  886. if the archive happens to contain some other files too, like BBS adverts.
  887.  
  888. You need: 
  889. - LhA, LZX or UnZip, according to what kind of packed files you have.
  890.   Define the exact location of each (eg dh1:bucket/lha)
  891. - 'Run' and 'Delete' commands in C: (or in path).
  892.  
  893. ** Hints **
  894. - Archived files may be packed with XPK, FImp, Powerpacker or whatever
  895.   format XFDmaster.library can decrunch.
  896.   For example, you could use xpkDLTA to encipher a module and then LhA it.  
  897.   Gives very good compression of sound related data.
  898. - You can store both TFMX mdat.  and smpl.  files in one archive!
  899.  
  900. ** Kick 1.2/1.3 note **
  901. LhA is probably the only one that will work fine.
  902.  
  903.  
  904.  
  905. Archiver commands
  906. -----------------
  907.  
  908. LhA: c:lha >nil: x -IqmMNQw "%s"
  909. °°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°°
  910. c:lha        the program lha with complete path
  911. >nil:        ignore any output
  912. x        extract files
  913. -IqmMNQw    I    ignore LHAOPTS variable
  914.         q    be quiet
  915.         m    no messages for query
  916.         M    no autoshow files
  917.         N    no progress indicator
  918.         Qw    disable wildcards
  919. "%s"        the %s is the archive to be extracted.
  920.  
  921. LZX: lzx >nil: -m -q x "%s"
  922. °°°°°°°°°°°°°°°°°°°°°°°°°°°
  923. -m -q        m    no messages for query
  924.         q    be quiet
  925. x        extract files
  926.  
  927. Zip: unzip >nil: -qq "%s"
  928. °°°°°°°°°°°°°°°°°°°°°°°°°
  929. -qq        qq    be very quiet
  930.  
  931.     
  932.  
  933.  
  934.  
  935. Doublebuffering
  936. ---------------
  937. Normally when loading a module the one that is playing is ejected.  With
  938. this button you can force HiP to play the current module and load the next
  939. one at the same time.  Useful for floppy users, no delays between playing.
  940. If there's not enough memory to hold two mods at the same time the one that
  941. is played will be ejected before loading.
  942.  
  943.  
  944.  
  945. XPK identify
  946. ------------
  947. When on, all XPKed files will be checked if they should be loaded in FAST
  948. memory.  You should set this if you listen to modules played by PS3M.
  949.  
  950.  
  951.  
  952. XFDmaster library
  953. -----------------
  954. Use XFDmaster.library to load packed files of almost any packer format.
  955. xfdmaster.library in libs:  needed of course.
  956.  
  957.  
  958.  
  959. File match pattern
  960. ------------------
  961. Match pattern for file requesters.
  962.  
  963.  
  964.  
  965. PS3M settings
  966. -------------
  967. This replayer (by Guru/S2) can play S3Ms, XMs, FTMs, MODs and MTMs.
  968.  
  969. Play mode:     Playing modes (see the PS3M doc for more info, or just
  970.                 try them out)
  971. Priority:
  972.     Pri -10 to +9
  973.           Set priority for the system friendly player process.
  974.     Killer    Disable system and stop most of the DMA to get the best
  975.                   quality. The blue flickering represents free CPU time.
  976.           Stop playing by pressing mousebuttons.  No enforcer!
  977.  
  978. Mixing buffer size:
  979.     4kB, 8kB, 16kB, 32kB mixing buffer size.
  980.     Smaller buffer gives faster response, but decreases the
  981.     "backup" buffer possibly causing more "skipping".
  982.  
  983. Mixing rate:
  984.     Mixing rate in kHz.
  985.  
  986. Volume boost:
  987.     Makes the sound clearer and louder (use when 8 or more channels)
  988.     You will hear the change almost immediately.
  989.  
  990. Stereo:
  991.     Works only with Surround play mode! 
  992.     You can adjust the strength of stereo. 0% is mono, 100% is stereo,
  993.     and 50% is the normal surround value.
  994.  
  995. Use S:HippoPlayer.PS3M configuration file:
  996.     Use a special configuration file for configuring PS3M.
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002. Save, Use, Cancel
  1003. -----------------
  1004. I guess you can guess these.  If you close the prefs window it's same as
  1005. 'Cancel'ling.  The prefs-file will be saved in the S:  directory.
  1006.  
  1007. *** NOTE:  Positions of the windows and some requesters are saved too.
  1008.  
  1009.  
  1010.  
  1011. ******************************************************************************
  1012. *                        *** Command line options ***                  *
  1013. ******************************************************************************
  1014.  
  1015. Add modules to the list
  1016. -----------------------
  1017. HiP  <file2> <file2> ... <file16>
  1018.  
  1019. All the files will be added to the list and the first added one will be
  1020. played.
  1021.  
  1022.  
  1023. Load a module program
  1024. ---------------------
  1025. HiP PRGM <module program>
  1026.  
  1027. The program will be loaded and the first module will be played.  If the
  1028. playmode is set as 'Modules in random order', then a random module will be
  1029. picked and played.  Existing list will be cleared.  (The PRGM-keyword is
  1030. not necessary, but is faster in terms of disk activity.)
  1031.  
  1032. All filenames must be entered with full paths!
  1033.  
  1034. *** NOTE:  You can also do these things while HiP is ALREADY running!  This
  1035. allows you to use HiP as a command line module player.  Eg in Directory
  1036. Opus it makes a good play button.
  1037.  
  1038.  
  1039. Hide on startup
  1040. ---------------
  1041. HiP HIDE [other parameters]
  1042.  
  1043. HIDE makes HiP even more a command line player.  It will force HiP not open
  1044. it's window.  Also reqtools.library is not needed (it will be loaded later
  1045. if the window is opened).  HiP can be controlled with hotkeys (if enabled)
  1046. and/or ARexx if the window is not opened.
  1047.  
  1048.  
  1049. Quit
  1050. ----
  1051. HiP QUIT
  1052.  
  1053. If there is already one HiP running, it will be terminated.
  1054.  
  1055.  
  1056.  
  1057. ******************************************************************************
  1058. *                              *** ARexx ***                           *
  1059. ******************************************************************************
  1060.  
  1061. HiP has an ARexx port 'HIPPOPLAYER'.  It will be initialized at startup if
  1062. RexxMaster is found running.  There are some simple ARexx-examples in the
  1063. ARexx-dir.
  1064. *** Note!  The ARexx-interface is not very thoroughly tested.
  1065. If there appears any misbehaviour, please tell me!
  1066.  
  1067. Parameters in [] may be omitted, parameters in <> may not!
  1068.  
  1069. CHOOSE <num>        Choose file number <num> in list.
  1070. ADD [file]        Add file [file] to list. If not specified, open
  1071.             file requester.
  1072. DEL            Delete chosen file from list.
  1073. CLEAR            Clear list.
  1074. MOVE <num>        Move chosen module after file number <num>.
  1075. INSERT <file>        Insert file <file> after chosen file.
  1076. SORT            Sort file list.
  1077. LOADPRG [file]        Load program [file]. If not specified, open
  1078.             file requester.
  1079.  
  1080. PLAY [file]        If [file] is given, clear list and play it. Otherwise
  1081.             play chosen file. If there's no files in list then
  1082.             open file requester.
  1083. EJECT            Stop playing and free current module.
  1084. STOP            Stop playing.
  1085. CONT            Continue playing after stop.
  1086. SONGPLAY <num>        Play song number <num>.
  1087. RANDPLAY        Pick a random module and play it.
  1088. FFWD            Jump forwards in song.
  1089. REW            Jump backwards in song.
  1090. VOLUME <vol>        Set volume <vol> (0-64).
  1091.  
  1092. QUIT            Close all windows and exit program.
  1093. ZIP <0/1>        0: small main window, 1: normal main window
  1094. HIDE <0/1>        0: hide main window, 1: show main window
  1095. PUBSCREEN <screen>    Set public screen for HiP's windows & requesters.
  1096.             Note that this is case sensitive.
  1097.  
  1098. TIMEOUT <secs>        Set timeout (0-600 secs).
  1099. PS3MBOOST <value>    Set PS3M volume boost (0-8).
  1100. PS3MMODE <mode>        Set PS3M mode. 1: surround, 2: stereo, 3: mono,
  1101.             4: real surround, 5: 14-bit stereo.
  1102. PS3MRATE <rate>        Set PS3M mixing rate (5000-56000).
  1103.  
  1104. LOADPREFS <file>    Load prefs file. Restart HiP with new settings.
  1105.             HiP only saves prefs to S:HippoPlayer.prefs, so
  1106.             you have to collect them manually somewhere for
  1107.             ARexx-usage.
  1108.  
  1109. SAMPLES            Open module info window.
  1110.  
  1111. GET <xxxx>    With this command you can get different information from HiP.
  1112.         The <xxxx> can be one of the following:
  1113.         xxxx:    result:
  1114.         PLAY    0 if not playing, 1 if playing.
  1115.         CFIL    Number of chosen file, 0 if none chosen.
  1116.         NFIL    Number of files in list.
  1117.         CURR    Number of loaded module.
  1118.         NAME    Module name.
  1119.         TYPE    Module type.
  1120.         CNAM    Name of chosen file.
  1121.         CSNG    Current song number.
  1122.         NSNG    Number of songs available.
  1123.         CSPO    Current song position.
  1124.         MSPO    Maximum song position.
  1125.         FNAM    Full name of loaded file.
  1126.         COMM    File comment of loaded file.
  1127.         SIZE    Size of loaded file.
  1128.         DURA    Module duration in seconds (returns 0 if Time/
  1129.                         duration is not enabled).
  1130.         HIDS    0 if main window not hidden, 1 if hidden.
  1131.         FILT    0 if filter off, 1 if filter on
  1132.             
  1133.  
  1134. ******************************************************************************
  1135. *                              *** Developers ***                            *
  1136. ******************************************************************************
  1137.     
  1138. HiP has a tiny interface for programmers who want to c0de some scopes of
  1139. their own.  Check out the example source(s)!
  1140.  
  1141. What you do is FindPort() "HiP-Port".  If unsuccesful, HiP is not running.
  1142. Otherwise, you get the pointer to HippoPlayer's port.  It looks like this:
  1143.  
  1144.     STRUCTURE       HippoPort,MP_SIZE
  1145.     LONG            hip_private1    * Private..
  1146.     APTR            hip_kplbase     * Protracker replayer data area
  1147.     WORD            hip_reserved0   * Private..
  1148.     BYTE            hip_reserved1   * Private..
  1149.     BYTE            hip_opencount   * Open count (see below)
  1150.     BYTE            hip_mainvolume  * Main volume, 0-64
  1151.     BYTE            hip_play        * If non-zero, HiP is playing
  1152.     BYTE            hip_playertype  * 33 = Protracker, 49 = PS3M
  1153.     *** Protracker ***
  1154.     BYTE            hip_reserved2
  1155.     APTR            hip_PTch1       * Protracker channel data for ch1
  1156.     APTR            hip_PTch2       * ch2
  1157.     APTR            hip_PTch3       * ch3
  1158.     APTR            hip_PTch4       * ch4
  1159.     *** PS3M ***
  1160.     APTR            hip_ps3mleft    * Buffer for the left side
  1161.     APTR            hip_ps3mright   * Buffer for the right side
  1162.     LONG            hip_ps3moffs    * Playing position
  1163.     LONG            hip_ps3mmaxoffs * Max value for hip_ps3moffs
  1164.     *** Protracker ***
  1165.     BYTE            hip_PTtrigger1
  1166.     BYTE            hip_PTtrigger2
  1167.     BYTE            hip_PTtrigger3
  1168.     BYTE            hip_PTtrigger4
  1169.  
  1170.     *** PT channel data block
  1171.     STRUCTURE       PTch,0
  1172.     LONG            PTch_start      * Start address of sample
  1173.     WORD            PTch_length     * Length of sample in words
  1174.     LONG            PTch_loopstart  * Start address of loop
  1175.     WORD            PTch_replen     * Loop length in words
  1176.     WORD            PTch_volume     * Channel volume
  1177.     WORD            PTch_period     * Channel period
  1178.     WORD            PTch_private1   * Private...
  1179.  
  1180. *** NOTE:  DON'T WRITE ANYTHING TO THE PORT!
  1181.  
  1182. *** hip_opencount ***
  1183.  
  1184. As soon as you get the pointer to HippoPlayer's port, add 1 to
  1185. hip_opencount.  When you are done, subtract 1 from hip_opencount.
  1186.  
  1187. *** PT hints ***
  1188.  
  1189. Each channel has it's own trigger byte:  hip_PTtrigger1, hip_PTtrigger2
  1190. etc..  When a new sample starts to play, the corresponding channel trigger
  1191. is incremented by 1.
  1192.  
  1193. PTch_start is updated so that it always points to the current playing
  1194. position of the sample.  PTch_length will decrease until it hits zero.
  1195. When this happens, PTch_start is replaced with PTch_loopstart and
  1196. PTch_length is replaced with PTch_replen.  In other words, the sample
  1197. loops.  If the loop size is 2 bytes (PTch_length = 1, PTch_replen = 1),
  1198. the sample stops (plays null).  Don't read past the sample data; always
  1199. check PTch_length.
  1200.  
  1201. The hip_kplbase points to the data area of my Protracker replayer.  This
  1202. makes it possible to do scopes like patternscope.  Contact me if you want
  1203. the structure definition.
  1204.  
  1205. *** PS3M hints ***
  1206.  
  1207. hip_ps3moffs is an offset from the start of the buffers pointing to the
  1208. current playing position.  Don't read past bufferstart+hip_ps3mmaxoffs.
  1209.  
  1210.  
  1211.  
  1212. ******************************************************************************
  1213. *                            *** Known bugs ***                  *
  1214. ******************************************************************************
  1215.  
  1216. 1.  Main window refresh may get dangerously confused when when zipping
  1217. window via zoomgadget while loading module/program, saving program or
  1218. sorting.  One zip is allowed, two is too much, so be careful.
  1219.  
  1220. 2.  Timeout and alarm don't work if there's no timer visible in the
  1221. titlebar.
  1222.     
  1223. 3.  Some Fred modules cause enforcer hits.
  1224.  
  1225. 7.  Sonic Arranger tunes tend to crash sometimes. 
  1226.  
  1227. 8.  Scopes bug with PT 9xx command.  This one originates from the
  1228. Protracker itself (my PT replayer really is 100% PT compatible :)
  1229.  
  1230.  
  1231. ** NOTE:  I've been getting complaints about the gadgets in HippoPlayer,
  1232. mostly because the pressed gadgets look ugly on 8+ color screens.  I use
  1233. STANDARD gadgets in HiP, the ugly coloring is AmigaOS's fault, not mine.
  1234. If someone knows how to correct the problem - some other way than using any
  1235. of those terrible GUI libraries - please tell me.
  1236.  
  1237.  
  1238.  
  1239. ******************************************************************************
  1240. *                              *** History ***                           *
  1241. ******************************************************************************
  1242.  
  1243. Read this!  Some things are not mentioned elsewhere!
  1244.  
  1245.  
  1246. v2.00 (19.3.1995)
  1247. -----------------
  1248.     * ARexx support
  1249.     * Public screen support
  1250.     * Keyboard control changes: you can use the keys without activating
  1251.       the window first by pressing lamiga-lshift-control-<key>.    
  1252.     * New PS3M: support for Fasttracker 2 (XM) modules.
  1253.     * Improved outlook.
  1254.     * Patched playsid.library so that it's possible to play SID-tunes
  1255.       also on kick1.2/1.3.
  1256.     * Prefs: continue on error, hotkeys, nasty audio, doublebuffering,
  1257.              program dir selector.
  1258.     * Main window: move, insert, sort (hidden under insert)
  1259.     + Timeout has now two modes.
  1260.     + You can 'Add', 'New' and 'In' directories.
  1261.     + New The Player v6.1a replayer.
  1262.     + PT replayer causes no serialstops.
  1263.     + Command line: HIDE, QUIT.
  1264.     + Prefs: PS3M volume boost has immediate effect on music.
  1265.     + Included some support progs.
  1266.     · PSID-files are loaded in public mem if possible.
  1267.     · HiP can be hidden with lamiga-lshift-control+h.
  1268.     · Key for toggling current scope.
  1269.     · Uses less CPU than v1.40 when not playing.
  1270.     · Filebox routines optimized & jump scroll with shifts.
  1271.     · New algorithmic random generator (thanks Thomas!).
  1272.     · If PT replayer is set as 'Fastram', modules smaller than
  1273.       the replayer's chip buffers (256kB) will be loaded in chipram.. :)
  1274.     · Recognizes .Lha .lHa .lHA like suffixes too.
  1275.     · Only 8 channel Oktalyzer-tunes are loaded in fast ram.
  1276.     · Faster gadget disabling/enabling (OffGadget() was sloooow).
  1277.     · Fixed and enforcer hit when toggling prefs window.
  1278.     · Bug fix in the doc: the player table had some wrong info.
  1279.     · General good stuff and nice things.
  1280.         
  1281. v2.05 (3.5.1995)
  1282. ----------------
  1283.     * Some fixes and improvements here and there.
  1284.     * Keyboard: K/L swapped back with ARROW LEFT/ARROW RIGHT.
  1285.             Added lot's of functions to number pad.
  1286.     * MED: multisong support, song position/song length, forward,
  1287.            rewind, songend. Also no lib-error bug removed.
  1288.     * New PT FAST RAM replayer which uses only 1024 bytes of CHIP RAM.
  1289.     * Replaced GZip support with LZX.
  1290.     * New music formats: Mark II, Maniacs of Noise, David Whittaker,
  1291.                  BP SoundMon v3.0 (v2.2?).
  1292.     * Prefs: VBlank timing selector, switch for scope bars.
  1293.     - Added zoom-gadget (kick2.0+).
  1294.     - Directories are added recursively (kick2.0+).
  1295.     - Fix: PS3M with killer mode caused crashes (my fault).
  1296.     + Added Humble mode for PS3M: priority = -3.
  1297.     + PS3M mixing buffer size can be as high as 64kB.
  1298.     - Fix: randomgenerator bugged heavily (jammed the machine).
  1299.     - Fix: PT replayer patterndelay + volslide.
  1300.     - Double buffering: if not enough memory, dump current module and
  1301.       try again.
  1302.     - When adding modules via AppWindow or commandline they are
  1303.       added to the end of the list, instead of first clearing the list
  1304.       and then adding.
  1305.     - Filter status saved in prefs file. Wasn't saved in prev. versions!
  1306.     - File selection bar is always kept visible.
  1307.     - Better init error handling.
  1308.     - The sort routine is six times faster than before.
  1309.     - Priority affects all processes excluding HippoScope.
  1310.     - Windows adapt with different border sizes (works with sysihack).
  1311.     - Titlebar info: clock and free mem shown at the same time.
  1312.     - Keys works from prefs window too.
  1313.     - A new icon by Cyclone.
  1314.  
  1315. v2.06 (19.5.1995)
  1316. -----------------
  1317.     * External player group.
  1318.     + Selectable 8x8 pixel font (kick2.0+).
  1319.     + Title of the sample name window now contains name, comment and size.
  1320.     + Timing is done with CIAA timer. Serialstops should finally
  1321.       be gone now..
  1322.     - Hide had a big bug! Terminated it. (Hi Yolk! (I'm an idiot))
  1323.     - Fixed a bug in HiP-script (LZX extraction).
  1324.     - Pressing 'Use' in prefs window will also change the scope.
  1325.     - Fade volume on exit.
  1326.     - A new icon by Roman Patzner.
  1327.     - Fixed a bug in ZIP (ARexx).
  1328.     - Some PS3M bugs removed.
  1329.     - Some fixes...
  1330.  
  1331. v2.07 (26.6.1995)
  1332. -----------------
  1333. Bug fixes:
  1334. - Continue on error no longer causes neverending load and fail-loops.
  1335. - PS3M buffer max size reduced to 32kB (64kB didn't always work well).
  1336. - Removed a bug in the font selector (no more memory and time waste).
  1337. - 'New' clears the list only if some mods were selected.
  1338. - PT fastram player bug removed (the one that jammed the machine).
  1339. - Timeout works with doublebuffering now.
  1340. - LhAed TFMX mdat+smpl loading with doublebuffering had a really
  1341.   serious bug. Killed it.
  1342. - Another bug with LhA and TFMX removed. Probably caused crashes if
  1343.   the length of the MDAT file was odd.
  1344. - Pos/len and NS/PS didn't work with MED MMD2 modules (I don't have the
  1345.   format description!), so I removed them.
  1346. - ARexx command PLAY was documented misleadingly. Corrected.
  1347.     
  1348. Improvements:
  1349. - Little fixes and improvements here and there.
  1350. - Find files in list.
  1351. - Alarm clock! :)
  1352. - New music formats: Old Soundtracker, Hippel, Hippel-COSO.
  1353. - SID-info and sample name windows update when a new module is loaded.
  1354. - Totally new cycle gadget mult.choice requester with right mousebutton!
  1355. - 'Center name' improved so that doubleclicking is more easier.
  1356. - Option to show duration of Protracker modules.
  1357. - MED-player will try to allocate the serial port for playing MIDI
  1358.   modules.
  1359. - New PS3M replay version: 0.951. Lot's of bugs removed.
  1360. - Moved PS3M into player group.
  1361. - Config file for PS3M, like the one in PS3M the player by Guru.
  1362. - PS3M Surround stereo slider.
  1363. - PS3M Humble and Friendly modes replaced with priority selector.
  1364. - PS3M now uses CIAA timer which doesn't cause serial stops like CIAB.
  1365.   (The CIAB can be selected in the PS3M config if the user really wants.)
  1366. - New DMA wait routine for PT replayer by Peter Kunath.
  1367. - Changing scope will have immediate effect.
  1368. - No pop-screen-to-front at startup anymore.
  1369. - Improved LhA, LZX and Zip file indentification.
  1370. - Tools: WaitHiP, HiPlay, PSIDcomment.
  1371. - New MWB icons by Roman Patzner.
  1372. - New NewIcons icon by David Wiles.
  1373. - HiP.guide by Tuomas Lukinmaa.
  1374.  
  1375. v2.08 (21.7.1995)
  1376. -----------------
  1377. Bug fixes:
  1378. - 'Play Module once' bug removed.
  1379. - Changed to use the old DMA wait in the PT replayer because the new
  1380.   one didn't always work fine.
  1381. - Added RMB listselector for main program priority.
  1382. - Tried to play MED mods even when an init error occured. Fixd.
  1383. - PT module duration calculation routinetion [:-] locked up in some
  1384.   situations.  Fxd.
  1385. - PT module end-detect fix.
  1386. - PS3M configuration file parser had a bug.  Messed up priorities with
  1387.   killer mode.  Fd.
  1388. - Doublebuffering works with dropped-icon modules.
  1389. - Dropped modules get played immediately even with random play.
  1390. - PSID file identification with .info now recognizes more files.
  1391. - Crashed when couldn't open font.  F.
  1392. - Some problems fxd with song names and PS3M.
  1393. - 'Continue on error' failed with unknown modules.
  1394. - PT sampleoffset now actually works 100% correctly.  Hi Yolk & Guru!  :)
  1395. - Recognizes *.LZH.
  1396. - Major bug removed in random play..
  1397.  
  1398. Improvements:
  1399. - Added mouse waitpointer.
  1400. - Better MarkII, Hippel and Hippel-COSO identifying.
  1401. - Included a HiP brush by Roman Patzner.
  1402. - No volume fade on exit.
  1403. - Volume fade works a bit better with PS3M.
  1404. - Scope window is closed when no data is available.
  1405. - List selector in prefs can be cancelled by clicking outside the window.
  1406. - If a module that is played contains subsongs, all of them are played
  1407.   before next module is loaded.  Works with play modes 'List repeatedly' &
  1408.   'List once' and with end-detectable modules, and with timeout.
  1409.  
  1410. v2.09 (28.7.1995)
  1411. -----------------
  1412. AARGH!!  v2.08 had an old version of the PS3M!  :-(((((((((( This version
  1413. has the new one (same as the version in v2.07)...
  1414.  
  1415. Improvements:
  1416. - New scope
  1417. - A little change in PatternScope concerning VU-meters.
  1418.  
  1419. v2.10 (2.9.1995)
  1420. ----------------
  1421. Bug fixes:
  1422. - Some little ones here and there.
  1423. - DMA wait bug fixes: Protracker, JamCracker, Soundmon, Hippel-COSO.
  1424.   Lost notes on screenmodes with high refresh rate.
  1425. - Enforcer hit with right mousebutton removed.
  1426. - Commandline stuff bugs removed.
  1427. - Enforcer hits with scopes fixed.
  1428.  
  1429. Improvements:
  1430. - List dividers.
  1431. - Filename prefix cut.
  1432. - Early load.
  1433. - New fast forward mode.
  1434. - RMB function indicators (DOpus style).
  1435. - New Prefs organization.
  1436. - Changed the position of 'cursor' in patternscope.
  1437. - IFF 8SVX sample playing.
  1438. - Added SAMPLES ARexx command.
  1439. - ARexx command PLAYSONG bugged. Replaced with SONGPLAY that works.
  1440. - Little interface for programmers.
  1441. - Thickened the quadra/stereoscopes.
  1442. - Moved the info from the title of the sample window into the window itself.
  1443. - The position of the sample name window and the info window are saved.
  1444. - Sample windows not opened by the user no longer inactivate the main
  1445.   window.
  1446. - Join module lists with RMB and 'Lp'.
  1447. - Improved sort routine:
  1448.    * Sorting accuracy 24 characters
  1449.    * Divided sections are sorted separatedly
  1450.    * Prefix cut compatible
  1451.    * Not very fast. I'm still using bubble sort...
  1452. - Skip setting of values in PS3M config file with ?'s.
  1453. - Included Filer-ARexx script by Janne Simonen.
  1454. - Increased PS3M maximum mixingrate from 56 kHz to 58 kHz after finding out
  1455.   it is actually possible.
  1456. - HippoScope for PS3M:  doubled the vertical pixel size, doubled the amount
  1457.   of pixels on 020+ Amigas.
  1458. - NOTE THIS:  The PRG keyword has been changed to PRGM!
  1459.  
  1460. v2.11 (6.9.1995)
  1461. ----------------
  1462. Bug fixes:
  1463. - Some little fixes.
  1464. - v2.10 had a test version Protracker replayer...  Argh!  :( Well it works
  1465. fine and is faster but doesn't always sound the same as the original
  1466. Protracker.  So back to the old replayer in this version.
  1467.  
  1468. Improvements:
  1469. - Scope opens again when possible.
  1470. - Dir add with divider/dir now adds dividers to all dirs.
  1471.  
  1472.  
  1473. v2.12 (16.9.1995)
  1474. -----------------
  1475. Bug fixes:
  1476. - Some.
  1477.  
  1478. Improvements:
  1479. - Redone the programmer interface.
  1480. - External scopes included.
  1481. - Example scope source included.
  1482. - Loading progress indicator for XPK files.
  1483. - Filled stereoscope for PS3M.
  1484. - Hipposcope for PS3M:  2x1 pixels instead 1x2 pixels.  Also no extra dots
  1485. with 020+ CPUs anymore.
  1486.  
  1487.  
  1488. v2.20 (27.10.1995)
  1489. ------------------
  1490. Bug fixes:
  1491. - Some..
  1492. - PS3M stereo didn't get updated unless the Prefs window was opened.
  1493. - hip_play in HiP's port wasn't updated!  Fixed.
  1494. - Nasty bug defeated in font requester! Corrupted the archiver commands..
  1495. - Some fixes in PT replayer.
  1496. - Bug fixed in Examplescope-source.
  1497.  
  1498. Improvements:
  1499. - New prefs system with paging.
  1500. - Listview for module info (sample names, PSID-info etc)
  1501. - New PS3M:  0.959 (20.9.1995).  NOTE!  The XM player is from the old PS3M,
  1502.   because the new XM player sucked..  Hi Guru!
  1503. - Removed the CIA selector from HippoPlayer.PS3M, currently PS3M always
  1504.   uses CIAA if possible.
  1505. - Pattern match for file requester.
  1506. - XFDmaster.library support for loading all kinds of packed files.
  1507. - Support for Alexis Nasr's combined TFMX mdat+smpl format (TFHD).
  1508. - If there's not enough chip memory, unpacked and XPK packed (with XPK
  1509.   identify) PT modules will be loaded to fast memory.
  1510. - If possible, CIAB is used for DMA wait.  No interrupts included!
  1511. - Better Old Soundtracker idenfication.
  1512. - Max timeout increased to 30 mins.
  1513. - Alarm now has a slider (hh:mm).
  1514. - Included xVUmeter.
  1515. - Included HiPScope with the C source and header file by Thomas Skoldenborg.
  1516.  
  1517. v2.21 (16.12.1995)
  1518. ------------------
  1519. Bug fixes:
  1520. - Quite a bunch removed.
  1521. - Found & killed many memory mangling bugs.
  1522. - Scope 'data follow speed' problems fixed.  Should work on all the
  1523.   standard monitor drivers.
  1524.  
  1525. Improvements:
  1526. - New, fast and amazing LhA/LZX/Zip loader that scans each archive for
  1527.   music modules! Archives with 100 BBS adverts and one module will work
  1528.   fine.  BTW, delete the HiP-script file.  It's no longer needed.
  1529.  
  1530. - New mode for player group: Load single.
  1531.  
  1532. - Info & main window scrolling now with optimized blitter power.
  1533. - PS3M mixing rate printed into the info window.
  1534. - Info window open/close status saved in prefs file.
  1535.  
  1536. - DIGI Booster support.  May be removed from the later releases.  You
  1537.   should try out the tracker, it's great.  Thanks to Tomasz Piast (Tap)
  1538.   for giving me the replayer source.
  1539.  
  1540. - Exit the module info by pressing Escape (in the window that is).
  1541. - Nuke key: [BACKSPACE+SHIFT]. Will remove a file from the list as well as
  1542.   from the DISK!
  1543.  
  1544. - Bigger jump in PSID fast forward.
  1545. - Two new parameters for ARexx GET: DURA and HIDS.
  1546.  
  1547. - Some cosmetic changes.
  1548.  
  1549. - Included installer-script by Tomasz Kepa.  Thanks! 
  1550.   Some modifications by me.
  1551. - Included French docs by Alan Guillevic. Thanks!
  1552. - Included HiP-ARexx-Play.rexx script by Marcel Döring
  1553.   <DonDoringo@GURU.rhein-main.de>.  Thanks!
  1554. - Included a Hippo drawer icon by Richard Harris. Thanks!
  1555.  
  1556.  
  1557. v2.22 (26.12.1995)
  1558. ------------------
  1559. Bug fixes:
  1560. - Forgot to fix in the last version:  info window could only open to
  1561.   Workbench screen. 
  1562. - Player group handling had a random memory allocation bug..  :(
  1563. - PS3M is known to cause crashes when writing to floppy.  I did something
  1564.   to the PS3M interrupt servers and the problem seems to be gone now.
  1565.   Who knows for sure...
  1566. - Installer script fixed. Tried to copy the obsolete HiP-script too.
  1567.  
  1568. Improvements:
  1569. - MED sample names are shown in the info window if possible.
  1570. - List dividers don't count as files anymore in the about window.
  1571. - Included SPIScope by Tuomas Lukinmaa.
  1572.  
  1573.  
  1574.  
  1575. v2.23 (7.4.1996)
  1576. ----------------
  1577.  
  1578. Bug fixes:
  1579. - Multitude of major & minor bugs removed.
  1580. - A severe bug in Load Single player group mode removed.
  1581. - Alarm fixed. Probably didn't work at all.
  1582. - Something fixed in VUMeter, shouldn't crash anymore.
  1583.  
  1584. Improvements:
  1585. - Quality assurance by a bunch of betatesters (yeah, sure :-)
  1586.  
  1587. - New PS3M 0.960.  Bugs fixed in Fasttracker II (XM), Screamtracker III
  1588.   (S3M) and Fasttracker I (FT) replay routines.  Fixed & updated by Peter
  1589.   Kunath / Delirium Softdesign (Hi!  Thanks!)
  1590.  
  1591. - SHIFT+BACKSPACE on a divider causes all the files 'under' that particular
  1592.   divider to be deleted from the list.
  1593. - Added RMB function for Del.  The same as SHIFT+BACKSPACE = delete file or
  1594.   delete divider and the files under it.
  1595.  
  1596. - RMB on the left 1/3 of the infobox = scope on/off.
  1597.  
  1598. - Info window: show the whole filecomment.
  1599.  
  1600. - Monoscope and filled monoscope for IFF sample player.
  1601.  
  1602. - Will now try CIAA first and then CIAB for timing.  Should work with
  1603.   other apps that require CIAA, like Shapeshifter.
  1604.  
  1605. - New DigiBooster replayer v1.4 by Tap.  (BEWARE:  the replayer
  1606.   causes non-lethal enforcer hits!)
  1607. - Added volume control for DigiBooster modules.
  1608.  
  1609. - Prefs: Prefs page saved in the prefs file.
  1610. - Prefs: Use/don't use HippoPlayer.PS3M configuration file.
  1611. - Prefs: Save window zip status (big window/title bar).
  1612. - Prefs: Sample buffer size.
  1613. - The file match pattern is now applied to all filenames, not only to those
  1614.   shown in the filerequester (kick2.0+).
  1615. - Filebox size can be set to 0: remove the whole thing from the window.
  1616.  
  1617. - LhA archive extraction should work on kick1.3 now.
  1618.  
  1619. - Player group mode 'Load all' will load med and psidplayer libraries.
  1620. - Module name in titlebar in all but 'Show clock, free mem'.
  1621.  
  1622. - ARexx GET: FILT
  1623. - ARexx: Some new scripts added. Check them out.
  1624.  
  1625. - Scopes can be run from WB.
  1626.  
  1627. - Included a MWB drawer icon and MWB icons for scopes.  Thanks go to Ilmari
  1628.   Karola for these.
  1629. - Some history cut from the doc.
  1630.  
  1631.  
  1632.  
  1633. ******************************************************************************
  1634. *                               *** Hellos ***                            *
  1635. ******************************************************************************
  1636.  
  1637. Jarno Paananen (Guru/Sahara Surfers)
  1638. - Hi my friend! Thanks for the PS3M etc. :)
  1639.  
  1640. Nico François
  1641.  - Thanks for the reqtools.library!
  1642.  
  1643. Ron Birk & Per Håkan Sundell
  1644. - Thanks for making almost perfect SID-emulation.
  1645.  
  1646. Official beta testers:
  1647. ----------------------
  1648. Jarkko Kemppainen (Mysdee/The Sharks), Mikko Karvonen (Yolk/Parallax), Timo
  1649. Rönkkönen (Deadbeat/The Sharks), Tommi Mäkilä (TjM/Parallax), Antti Lankila
  1650. (STL/Damage), Jarkko Vatjus-Anttila (Quaid/Big Fat Brothers), Tuomas
  1651. Lukinmaa (Tumu/Big Fat Brothers), Toni "Panadol" Kettula, Filip "Eliot"
  1652. Oscadal, Marcel Döring, Steve@Almathera Tech (THP), Kasper B.  Graversen
  1653.  
  1654. Those who have participated more or less, thanks:
  1655. -------------------------------------------------
  1656. Peter Kunath (Delirium Softdesign), Henryk Richter (Buggs/Defect), Tommi
  1657. Lindström, Richard Harris (FOXX), cYClone/nEW-dEAL^PSD PC, Roman Patzner,
  1658. David Wiles, Tuomas Lukinmaa (Tumu/BFB Team), Janne Simonen, Marcel Döring,
  1659. Tomasz Kepa, Ilmari Karonen, Jarkko Vatjus-Anttila (Quaid/BFB Team)
  1660.  
  1661. Special hellos:
  1662. ---------------
  1663. Agust Arni Jonsson (Nemesis1), Mikael Grahn, Jari Karjalainen, Ivan
  1664. Wheelwright, Jani Kannisto, Thomas Gylfe, Arto Ikola, Tommi Lempinen, Paul
  1665. Wellstead, Mikko Vartio, Pasi Laaksonen, Alan Guillevic, Armin Pigulla,
  1666. Mikko Manninen, Seppo Tomperi, Jari Mikkilä, Patrick Becker, P.Koistinen,
  1667. Juha Laukkanen, Jan Svihus, Gunnar Andersson, Ragnar Fyri, Roman Patzner,
  1668. Edouardo Gonçalves, Svein Skjæveland, Petri Ala-Louesniemi, Jari Ketola,
  1669. Olivier Delemotte, Markku Luukkainen, Ralf Neitzel, Janne Jusula, Philippe
  1670. Bovier, Jouko Tuisku, Luuk van der Duim, Sean Connolly (Odie/Cosine), Johan
  1671. Rönnblom
  1672.  
  1673. Hellos to those who have sent me email and to whom I've talked on IRC.
  1674.  
  1675. Thanks to all the ones who have sent me registrations, bug reports &
  1676. suggestions!
  1677.  
  1678.  
  1679.  
  1680. ******************************************************************************
  1681. *                               *** About ***                           *
  1682. ******************************************************************************
  1683.  
  1684. HippoPlayer was made by using the Asm-One.  Pure assembler, source code
  1685. length without any includes or play routines is about 390kB.
  1686.  
  1687. Registrations, bug reports, comments & suggestions and C-64 warez are
  1688. welcome!  NO SWAPPING!!
  1689.  
  1690. Always mention your Amiga configuration and HiP version when sending bug
  1691. reports!
  1692.  
  1693.  
  1694.  Kari-Pekka Koljonen
  1695.  Torikatu 31
  1696.  40900 Säynätsalo
  1697.  Finland
  1698.  
  1699.  E-mail: kp@direktor.voima.jkl.fi
  1700.      kpkoljon@freenet.hut.fi
  1701.      (try freenet if you get no reply from direktor)
  1702.  
  1703.  WWW:     http://direktor.voima.jkl.fi/~kp
  1704.  
  1705.  IRC:     K-P (#amigascne mostly)
  1706.  
  1707.  Finns phone: 941-3742699 (19:00-21:00 Finnish Mean Time)
  1708.